home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / FIN.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  45 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _FIn( cFieldName, cFieldVal, cPassword ) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. cFieldName: Name of database field to write data
  12. cFieldVal : Data to be written to database field
  13. cPassword : Encryption Password (Optional)
  14.  
  15. SHORT:
  16.  
  17. Write data to database field, optionally with encryption.
  18.  
  19. DESCRIPTION:
  20.  
  21. _Fin() writes data to a database field.
  22.  
  23. If cPassword is specified, character fields are encrypted before writting.
  24. Encrypted fields maintain both leading and trailing spaces.  That is, if the
  25. value "     KIRBY     " is written and a password is specified, the result
  26. will be something to the effect of "     @f&3_     ".  The leading and
  27. trailing spaces are not included in the encryption because doing so makes
  28. breaking of the encryption much easier.
  29.  
  30. The _FOut() function will similarly restore leading and trailing spaces.
  31.  
  32. Non-Character fields are not encrypted.
  33.  
  34. NOTE:
  35.  
  36.  
  37.  
  38. EXAMPLE:
  39.  
  40. t = "This is a test"
  41.  
  42. _FIn('TESTFIELD',t,'PASSWORD')
  43.  
  44. ******************************************************************************/
  45.